Class: modelit.ui.Panel

Extends: modelit.ui.Jacontrol & modelit.ui.AbstractJacontrol & matlab.mixin.SetGet & handle & matlab.mixin.Heterogeneous

DESCRIPTION:

A container for a modelit.ui.Jacontrol object. The panel's border, background and title can be adjusted. The layout is managed by a gridbaglayout manager, see the add method

Properties

BackgroundColor RGB triple, default value is system dependent
 The background color of the panel.
BorderColor RGB triple, default value is [0 0 0]
 The color of the border of the panel.
BorderStyle 'none'
 The borderstyle
 String, default value: 'none'
 Possible values:
  'etchedin'
  'etchedout'
  'beveledin'
  'beveledout'
  'line'
BusyAction cancel | {queue}
 Callback queuing.
 Determines how MATLAB handles the execution of interrupting callbacks.
 A running callback is the currently executing callback. The interrupting callback is the callback that tries to interrupt the running callback.
 The BusyAction property of the interrupting callback determines how MATLAB handles its execution. When the BusyAction property is set to:
  'queue' ? Puts the interrupting callback in a queue to be processed after the running callback finishes execution.
  'cancel' ? Discards the interrupting callback as MATLAB finishes execution.
 For information about how the Interruptible property of the callback controls whether other callbacks can interrupt the running callback, see the Interruptible property description.
Children The component's children.
Clipping clipping
 Clipping mode.
 This property has no direct effect on the objects
 Use this property if you want to implement your own custom
ContextMenu Handle, default value: []
 The handle of the context menu associated with the panel.
 The context menu is displayed whenever you right-click on the panel.
 Use the Matlab uicontextmenu function to create the context menu.
Enable {on} | inactive | off
 Disable or enable the component.
 This property controls how components respond to user interaction.
 Possible values for this property:
  on ? The component is operational (the default).
  inactive ? The component is not operational, but looks the same as when Enable is on.
  off ? The component is not operational and is grayed out.
Extent Width and height are the dimensions of the rectangle. All measurements are in units specified by the Units property.
 Position rectangle (read only).
 A four-element vector that defines the size and position of the component.
 It has the form: [xpos,ypos,width,height]
 The first two elements are always zero are the component's position on the x- and y-axis. w
FontAngle {normal} | italic
 Setting this property to italic selects a slanted version of the component's font, when it is available on your system.
FontName String, default is system dependent.
 The name of the font in which to display the text in the components.
 To display and print properly, this must be a font that your system supports.
 Use listfonts to list all available system fontnames.
FontSize Integer, default value is system dependent.
 A number specifying the size in pixels of the component's font.
FontUnits {points} | normalized | inches | centimeters | pixels
 This property determines the units used by the FontSize property.
 Normalized units interpret FontSize as a fraction of the height of the uicontrol. When you resize the uicontrol, MATLAB modifies the screen FontSize accordingly.
 pixels, inches, centimeters, and points are absolute units (1 point = 1/72 inch).
FontWeight {normal} | bold
 Setting this property to bold selects a bold version of the component's font, when it is available on your system.
ForegroundColor RGB triple, default value is system dependent
 The foreground color (title color) of the panel.
Image String, default value '', no image is shown
 The filename of the image to be shown in the panel's background
Interruptible off | {on}
 Callback routine interruption.
 Controls whether MATLAB can interrupt an object's callback function when subsequent callbacks attempt to interrupt it.
JavaHandle Java object
 The underlying java object.
 See javacomponent
MatlabHandle Matlab handle
 The handle of the associated Matlab container for this java object.
 See javacomponent
MaximumSize Array, [width height]
 The component's maximum size, measured in pixels.
 The preferred size indicates the best size for the component.
 The component should be no larger than its maximum size and no smaller than its minimum size.
 NOTE: Matlab may overrule this setting if the component is not in
 a Panel, ScrollPane, Toolbar, SplitPane or TabbedPane.
MinimumSize Array, [width height]
 The component's minimum size, measured in pixels.
 The preferred size indicates the best size for the component.
 The component should be no larger than its maximum size and no smaller than its minimum size.
 NOTE: Matlab may overrule this setting if the component is not in
 a Panel, ScrollPane, Toolbar, SplitPane or TabbedPane.rtain layout managers.
MouseClickedCallback String, cell array or function handle, default value: []
 Specifies the function that should be executed when the mouse is clicked on the component
MouseEnteredCallback String, cell array or function handle, default value: []
 Specifies the callback function that should be executed when the mouse enters the component.
MouseExitedCallback String, cell array or function handle, default value: []
 Specifies the callback function that should be executed when the mouse exits the component.
NextFocusableComponent Jacontrol, default value: []
 Specifies the next component to get the focus after this one.
 for example, when the tab key or shift-tab key is used.
Parent The component's parent.
Position Array, [width height]
 Size and location of the component.
 The rectangle defined by this property specifies the size and location of the component within the parent.
 Specify Position as [left bottom width height]
 left and bottom are the distance from the lower-left corner of the parent object to the lower-left corner of the component.
 width and height are the dimensions of the component. All measurements are in units specified by the Units property.
PreferredSize Array, [width height]
 The component's preferred size, measured in pixels.
 The preferred size indicates the best size for the component.
 The component should be no larger than its maximum size and no smaller than its minimum size.
 NOTE: Matlab may overrule this setting if the component is not in
 a Panel, ScrollPane, Toolbar, SplitPane or TabbedPane.
ShadowColor RGB triple, default value is [0.5020 0.5020 0.5020]
 The shadow color of the border of the panel. Used when BorderType
 is etchedin, etchedout, beveledin or beveledout.
Style Panel (Read only)
Tag String, default value: ''
 User specified object identifier.
 Use this tag i.c.w. gcjh('tag',parent) to find a modelit.ui.Jacontrol
Title String, default value: ''
 The title of the panel
Type Read only property fixed to 'Jacontrol'
 String with the object type.
Units {pixels} | normalized | inches | centimeters | points | characters
 Used to interpret the extent and position properties.
 All units are measured from the lower-left corner of the parent object.
 Normalized units map the lower-left corner of the parent object to (0,0) and the upper-right corner to (1.0,1.0).
 pixels, inches, centimeters, and points are absolute units (1 point = 1/72 inch).
 Character units are characters using the default system font; the width of one character is the width of the letter x, the height of one character is the distance between the baselines of two lines of text.
 If you change the value of Units, it is good practice to return it to its default value after completing your computation so as not to affect other functions that assume Units is set to the default value.
Userdata Array, default value: []
 User specified data for this modelit.ui.Jacontrol object
Visible Off | {On}
 Component visibility.
 By default, all jacontrols are visible. When set to off, the jacontrol is not visible, but still exists and you can query and set its properties.

Public Method: cleanup

DESCRIPTION:

modelit.ui.Panel destructor

CALL:

delete(obj)

INPUT:

obj any
modelit.ui.Panel

OUTPUT:

   No output

Public Method: Panel

DESCRIPTION:

modelit.ui.Panel constructor

CALL:

obj = modelit.ui.Panel(parent, varargin)

INPUT:

parent any
handle of the Panel's parent e.g. gcf or modelit.ui.Panel
varargin any
parameter-value pairs, see Panel properties for a
description of the parameters and their values
Documentation for modelit.ui.Panel/Panel
   doc modelit.ui.Panel

Public Method: add

DESCRIPTION:

Add a component to this panel

CALL:

obj = add(obj, jac, y, x, varargin)

INPUT:

obj any
modelit.ui.Panel
jac any
modelit.ui.Jaconrol to be added to this panel
y any
integer, row in layout grid
x any
integer, column in layout grid
varargin any
  parameter value pairs: possible values:
- gridwidth, gridheight
    Specify the number of columns (for gridwidth) or rows (for gridheight) in the component's display area. These constraints specify the number of cells the component uses, not the number of pixels it uses. The default value is 1. Use GridBagConstraints.REMAINDER to specify that the component be the last one in its row (for gridwidth) or column (for gridheight). Use GridBagConstraints.RELATIVE to specify that the component be the next to last one in its row (for gridwidth) or column (for gridheight). We recommend specifying the gridwidth and gridheight values for each component rather than just using GridBagConstraints.RELATIVE and GridBagConstraints.REMAINDER; this tends to result in more predictable layouts.

    Note: GridBagLayout does not allow components to span multiple rows unless the component is in the leftmost column or you have specified positive gridx and gridy values for the component.

- fill
    Used when the component's display area is larger than the component's requested size to determine whether and how to resize the component. Valid values (defined as GridBagConstraints constants) include NONE (the default), HORIZONTAL (make the component wide enough to fill its display area horizontally, but do not change its height), VERTICAL (make the component tall enough to fill its display area vertically, but do not change its width), and BOTH (make the component fill its display area entirely).

- ipadx, ipady
    Specifies the internal padding: how much to add to the size of the component. The default value is zero. The width of the component will be at least its minimum width plus ipadx*2 pixels, since the padding applies to both sides of the component. Similarly, the height of the component will be at least its minimum height plus ipady*2 pixels.

- insets:
 vector: [top, left, bottom, right)
 Specifies the external padding of the component i.e. the minimum amount
 of space between the component and the edges of its display area.
 By default, each component has no external padding.

- anchor
    Used when the component is smaller than its display area to determine where (within the area) to place the component. Valid values (defined as GridBagConstraints constants) are CENTER (the default), PAGE_START, PAGE_END, LINE_START, LINE_END, FIRST_LINE_START, FIRST_LINE_END, LAST_LINE_END, and LAST_LINE_START.

    Here is a picture of how these values are interpreted in a container that has the default, left-to-right component orientation.

        -------------------------------------------------
        |FIRST_LINE_START   PAGE_START     FIRST_LINE_END|
        |                                                |
        |                                                |
        |LINE_START           CENTER             LINE_END|
        |                                                |
        |                                                |
        |LAST_LINE_START     PAGE_END       LAST_LINE_END|
        -------------------------------------------------

        Version note:  The PAGE_* and *LINE_* constants were introduced in 1.4. Previous releases require values named after points of the compass. For example, NORTHEAST indicates the top-right part of the display area. We recommend that you use the new constants, instead, since they enable easier localization.

- weightx, weighty
    Specifying weights is an art that can have a significant impact on the appearance of the components a GridBagLayout controls. Weights are used to determine how to distribute space among columns (weightx) and among rows (weighty); this is important for specifying resizing behavior.

    Unless you specify at least one non-zero value for weightx or weighty, all the components clump together in the center of their container. This is because when the weight is 0.0 (the default), the GridBagLayout puts any extra space between its grid of cells and the edges of the container.

    Generally weights are specified with 0.0 and 1.0 as the extremes: the numbers in between are used as necessary. Larger numbers indicate that the component's row or column should get more space. For each column, the weight is related to the highest weightx specified for a component within that column, with each multicolumn component's weight being split somehow between the columns the component is in. Similarly, each row's weight is related to the highest weighty specified for a component within that row. Extra space tends to go toward the rightmost column and bottom row.

Public Static Method: example

DESCRIPTION:

Show an example of a modelit.ui.Panel

CALL:

modelit.ui.Panel.example

INPUT:

    No input.
 

OUTPUT:

    No direct output

Public Method: delete

Inherited from modelit.ui.Jacontrol

DESCRIPTION:

modelit.ui.Jacontrol destructor.

CALL:

delete(obj)

INPUT:

obj any
modelit.ui.Jacontrol

OUTPUT:

   No output

Help for modelit.ui.Panel/delete is inherited from superclass MODELIT.UI.JACONTROL

Public Method: isappdata

Inherited from modelit.ui.Jacontrol

DESCRIPTION:

True if application defined data exists.

CALL:

value = isappdata(obj, name)

INPUT:

obj any
a modelit.ui.Jacontrol object
name any
string with the name of the application data

OUTPUT:

value any
    True if the application defined data exists
Help for modelit.ui.Panel/isappdata is inherited from superclass MODELIT.UI.JACONTROL

Public Method: getappdata

Inherited from modelit.ui.Jacontrol

DESCRIPTION:

Get application defined data.

CALL:

value = getappdata(obj, name)

INPUT:

obj any
a modelit.ui.Jacontrol object
name any
string with the name of the application data

OUTPUT:

value any
    The application defined data
Help for modelit.ui.Panel/getappdata is inherited from superclass MODELIT.UI.JACONTROL

Public Method: setappdata

Inherited from modelit.ui.Jacontrol

DESCRIPTION:

Set application defined data.

CALL:

setappdata(obj, name, value)

INPUT:

obj any
a modelit.ui.Jacontrol object
name any
string with the name of the application data
value any
value to be stored. May be anything

OUTPUT:

   No output. The application-defined data,
   which is created if it does not already exist, is
   assigned a name and a value.

Help for modelit.ui.Panel/setappdata is inherited from superclass MODELIT.UI.JACONTROL

Public Method: ishandle

Inherited from modelit.ui.Jacontrol

DESCRIPTION:

Returns true if this is a valid graphics object

CALL:

value = ishandle(obj)

INPUT:

obj any
a modelit.ui.Jacontrol object

OUTPUT:

value any
    boolean: true if this is a valid graphics object
    What does "valid" mean in this context??
    Matlab HG object/container that holds still exist?
Help for modelit.ui.Panel/ishandle is inherited from superclass MODELIT.UI.JACONTROL

Public Method: java

Inherited from modelit.ui.Jacontrol

DESCRIPTION:

Returns the underlying Java object

CALL:

jobj = java(obj)

INPUT:

obj any
a modelit.ui.Jacontrol object

OUTPUT:

jobj any
    java object
Help for modelit.ui.Panel/java is inherited from superclass MODELIT.UI.JACONTROL

Public Method: handle

Inherited from modelit.ui.Jacontrol

DESCRIPTION:

Returns the handle of the component's Matlab container

CALL:

h = handle(obj)

INPUT:

obj any
a modelit.ui.Jacontrol object

OUTPUT:

h any
    handle of the component's Matlab container
Help for modelit.ui.Panel/handle is inherited from superclass MODELIT.UI.JACONTROL

Public Method: ancestor

Inherited from modelit.ui.Jacontrol

DESCRIPTION:

Returns the handle of the closest ancestor of obj that matches one of the types in type,

CALL:

p = ancestor(obj, type)

INPUT:

obj any
modelit.ui.Jacontrol
type any
String or cell array of strings (types)

OUTPUT:

p any
      handle of the closest ancestor of the obj that matches one of the types in type
Help for modelit.ui.Panel/ancestor is inherited from superclass MODELIT.UI.JACONTROL

Protected Static Sealed Method: getDefaultScalarElement

Inherited from modelit.ui.AbstractJacontrol

DESCRIPTION:

Create a default object for heterogeneous arrays. Help for modelit.ui.Panel.getDefaultScalarElement is inherited from superclass MODELIT.UI.ABSTRACTJACONTROL

Public Sealed Method: ne

Inherited from modelit.ui.AbstractJacontrol

DESCRIPTION:

Not equal relation for handles. Help for modelit.ui.Panel/ne is inherited from superclass MODELIT.UI.ABSTRACTJACONTROL

Public Sealed Method: eq

Inherited from modelit.ui.AbstractJacontrol

DESCRIPTION:

Equal relation for handles. Help for modelit.ui.Panel/eq is inherited from superclass MODELIT.UI.ABSTRACTJACONTROL

Public Sealed Method: findobj

Inherited from modelit.ui.AbstractJacontrol

DESCRIPTION:

Returns the objects whose property values match those passed as param-value pairs to the findobj command. Help for modelit.ui.Panel/findobj is inherited from superclass MODELIT.UI.ABSTRACTJACONTROL

Public Sealed Method: set

Inherited from modelit.ui.AbstractJacontrol

DESCRIPTION:

Set object properties Help for modelit.ui.Panel/set is inherited from superclass MODELIT.UI.ABSTRACTJACONTROL